docs: Improve shortcut trigger docs

Point out the need to escape <> in xml.

diff --git a/gtk/gtkshortcuttrigger.c b/gtk/gtkshortcuttrigger.c
index 65e3164b5b2744245e51e12e25a694d682edd49f..8364932c59637dc22dd7d0c192b963cd493500d9 100644 (file)
--- a/gtk/gtkshortcuttrigger.c
+++ b/gtk/gtkshortcuttrigger.c
@@ -122,6 +122,10 @@ gtk_shortcut_trigger_trigger (GtkShortcutTrigger *self,
  *   - two valid trigger strings, separated by a `|` character, for a
  *     #GtkAlternativeTrigger: `<Control>q|<Control>w`
  *
+ * Note that you will have to escape the `<` and `>` characters when specifying
+ * triggers in XML files, such as GtkBuilder ui files. Use `&lt;` instead of
+ * `<` and `&gt;` instead of `>`.
+ *
  * Returns: (nullable) (transfer full): a new #GtkShortcutTrigger
  *   or %NULL on error
  */